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5.1  Introduction 

5.1.1  Description 

This  supplemental  document  contains  the  assembly  language  interface  for  the 
RTEMS  real-time  executive  for  the  Intel  80386.  For  more  detailed  information 
regarding  exact  operation,  constants,  arguments,  and  data  structures,  please 
refer  to  the  manual  page  for  the  appropriate  directive. 

Each  entry  in  this  supplemental  document  corresponds  to  a  directive  and  deteiils 
which  registers  are  used  for  input  arguments  and  return  values  in  addition  to 
an  example  usage.  The  examples  in  this  supplement  are  given  in  standard  Intel 
80386  assembly  language. 

5.1 .2  Register  Usage 

RTEMS-80386  uses  the  80386  EIAX,  ECX,  and  EDX  registers  as  scratch 
registers.  The  contents  of  these  three  registers  will  not  be  preserved  by  RTEMS 
directives  unless  noted  otherwise. 

5.1. 3  Segment  Usage 

RTEMS-80386  is  designed  to  operate  in  the  thirty-two  bit  flat  memory  model 
of  the  80386  with  paging  disabled.  In  this  mode,  the  80386  automatically 
converts  every  address  from  a  logical  to  a  physical  address  each  time  it  is  used. 
The  80386  uses  information  provided  in  the  segment  registers  and  the  Global 
Descriptor  Table  to  accomplish  this.  RTEMS-80386  assumes  the  existence  of 
the  following  segments: 

•  a  single  code  segment  at  protection  level  zero  (0)  which  contains 
all  application  and  executive  code. 

•  a  single  data  segment  at  protection  level  zero  (0)  which  contains 
all  application  and  executive  data. 

The  80386  segment  registers  and  associated  selectors  must  be  initialized  when 
the  init.exec  directive  is  invoked.  RTEMS-80386  treats  the  segment  registers 
as  system  resources  emd  does  not  modify  or  context  switch  them. 
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RTEMS-80386  does  not  require  that  logical  and  physical  addresses  are  the 
same,  although  it  is  desirable  in  many  applications  to  do  so.  If  logical  and 
physical  addresses  are  different,  the  application  may  require  an  additional 
selector  to  access  physical  addresses. 
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S.2  INITIALIZATION  MANAGER 
S.2.1  INIT  EXEC  -  Initialize  RTEMS 


INPUT; 

EAX  =  function  code 

4[ESP]  =  address  of  configuration  table 

OUTPUT: 

NONE 

EXAMPLE: 

push  offset  Conf_tbl 

mov  EAX,INIT_EXEC 

call  rtems 

;  does  not  return 


;  push  address  of  config  table 
;  EAX  =  function  code 
;  enter  the  executive 


NOTES: 

This  directive  does  not  return  to  the  caller. 
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S.3  TASK  MANAGER 
S.3.1  T_CREATE  -  Create  a  task 

INPUT: 

EAX  =  function  code 

4[ESP]  =  user-defined  four  byte  name 

8[ESP]  =  priority 

12[ESP]=  stack  size  (in  bytes) 

16[ESP]=  mode 
20[ESP]=  attributes 

24[ESP]  =  address  of  tar''  id  storage  location 
OUTPUT: 

EAX  =  directive  status  code 
EXAMPLE: 


push  offset  Task_id 

push  TASK_ATTRIBUTES 

push  TASK_MODE 

push  STACK_SIZE 

push  PRIORITY 

push  TASK_NAME 

mov  EAX , T_CREATE 

call  rtems 

;  should  check  return  code 


;  push  pointer  to  task  id 
;  push  attributes 
;  push  mode 
;  push  stack  size 
;  push  priority 
;  push  name 
;  EAX  s  function  code 
;  enter  the  executive 

here 
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S.3.2  TJDENT-GetIDofatask 


INPUT: 

EAX  =  function  code 
4[ESP]  =  user-defined  name  to  search  for 
8[ESP]  =  node  identifier  (defines  search  space) 
12[ESP]  =  address  of  task  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Task  id 

;  push  pointer  to  task  id 

push 

NODE 

;  push  node  identifier 

push 

TASK_NAME 

;  push  name 

mov 

T_I DENT, EAX 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 


S.3.3  T_START  -  Start  a  task 


INPUT: 

EAX  =  function  code 
4[ESP]  =  task  id 
8[ESP]  =  entry  point 
12[ESP]=  start  argument 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  TASK_ARG 

push  U8er_ta8k 

push  Ta8k_id 

mov  EAX,T_START 

call  rtems 

;  should  check  return  code 


;  push  start  argpment 
;  push  entry  point 
t  push  task  id 
}  EAX  =  function  code 
;  enter  the  executive 

here 
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S.3.4  T_RESTART  -  Restart  a  task 

INPUT: 

EAX  =  function  code 
4[ESP]  =  task  id 
8[ESP]  =  restart  argument 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

RESTART_ARG 

;  push  restart  argument 

push 

Task  id 

;  push  task  id 

mov 

EAX,T_RESTART 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 


S.3.5  T_DELETE  -  Delete  a  task 


INPUT: 

EAX  =  function  code 
4[ESP]  =  task  id 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  TaaJt_id  ; 
mov  EAX,T  DELETE  • 
call  rtems  • 

;  should  check  return  code  here 
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push  task  id 

BAX  »  function  code 

enter  the  executive 


S.3.6  T_SUSPEND  -  Suspend  a  task 


INPUT: 

EAX  =  function  code 
4[ESP]  =  task  id 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

push  Ta3k_id 

mov  EAX/T_SUSPEND 

call  •  rtema 


;  push  task  id 
;  EAX  =  function  code 
;  enter  the  executive 


;  should  check  return  code  here 


S.3.7  T_RESUME  -  Resume  a  task 


INPUT: 

EAX  =  function  code 
4[ESP]  =  task  id 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

;  push  task  id 
;  EAX  =  function  code 
;  enter  the  executive 

;  Should  check  return  code  here 


push  Task_id 

mov  EAX ,  T_RESUME 

call  rtems 
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S.3.8  T_SETPRI  -  Set  task  priority 


INPUT: 

EAX  =  function  code 
4[ESP]  =  task  id 
8[ESP]  =  new  priority 

12[ESP]=  address  of  previous  priority  storage  location 
OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Prev_priority 

push  PRIORITY 

push  Task_id 

mov  EAX,T_SETPRI 

call  rtems 


push  pointer  to  previous  priority 

push  new  priority 

push  task  id 

EAX  =  function  code 

enter  the  executive 


;  should  check  return  code  here 
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S.3.9  T.MODE  -  Change  current  task's  mode 


INPUT: 

EAX  =  function  code 
4[ESP]  =  new  mode 
8[ESP]  =  mask 

12[ESP]  =  address  of  previous  mode  storage  location 
OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Prev  mode 

;  push  pointer  to  previous  mode 

push 

MASK 

;  push  mask 

push 

NEW_MODE 

;  push  new  mode 

mov 

EAX,T_MODE 

;  EAX  >=  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 
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S.3.1 0  T_GETNOTE  -  Get  task  notepad  entry 

INPUT: 

EAX  =  function  code 

4[ESP]  =  task  id 

8[ESP]  =  notepad  entry  number 

12[ESP]  =  address  of  note  value  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Note  val 

;  push  pointer  to  note  value 

push 

NOTE_NUM 

;  push  entry  number 

push 

Task_id 

;  push  task  id 

mov 

EAX, T_GETNOTE 

;  EAX  =  function  code 

call 

r  terns 

;  enter  the  executive 

;  should  check  return  code  here 


S.3.1 1  T_SETNOTE  -  Set  task  notepad  entry 

INPUT: 

EAX  =  function  code 
4[ESP]  =  task  id 
8[ESP]  =  notepad  entry  number 
12[ESP]  =  note  value 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  NOTE_VALUE 
push  NOTE_NUM 

push  Task_id 

mov  EAX , T_SETNOTE 

call  rtema 

;  should  check  return  code  here 


;  push  note  value 
;  push  entry  number 
;  push  task  id 
;  EAX  »  function  code 
;  enter  the  executive 
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S.4  INTERRUPT  MANAGER 
S.4.1  I  ENTER  -  Enter  an  ISR 


INPUT: 

EAX  =  function  code 

OUTPUT: 

NONE 

EXAMPLE: 

push  EAX  ;  save  task's  EAX 

mov  EAX,I_ENTER  ;  EAX  =  function  code 

call  rtems  ;  enter  the  executive 

;  no  need  to  check  the  return  code  here 


NOTES: 

This  directive  uses  the  EAX  register  only.  This  register  must  be  saved  by  the 
application  before  invoking  I_ENTER  The  EuAX  register  is  restored 
automatically  by  the  I.RETURN  directive. 
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S.4.2  I  RETURN  -  Return  from  an  iSR 


INPUT: 

EAX  =  function  code 

OUTPUT: 

NONE 

EXAMPLE: 


mov  EAX/I_RETURN  ;  EAX  =  function  code 

call  rtems  ;  enter  the  executive 

;  will  never  return 


NOTES: 

This  directive  uses  the  ElAX  only.  It  restores  EAX  to  its  contents  prior  to 
invoking  I_ENTER. 

This  directive  does  not  return  to  the  caller. 
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S.5  TIME  MANAGER 

S.5.1  TM_SET  -  Set  system  date  and  time 


INPUT: 

EAX  =  function  code 

4[ESP]  =  address  of  timejnfo  data  structure 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

push  offset  Tiine_str  ;  push  pointer  to  time  buffer 

mov  EAX,TM_SET  ;  EAX  =  function  code 

call  rtems  ;  enter  the  executive 


;  should  check  return  code  here 


S.5.2  TM_GET  -  Get  system  date  and  time 

INPUT: 

EAX  =  function  code 

4[ESP]  =  address  of  timejnfo  data  structure 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

offset  Time_atr  ;  push  pointer  to  time  buffer 

EAX,TM_GET  ;  EAX  =  function  code 

rtems  •  enter  the  executive 

;  should  check  return  code  here 


push 

mov 

call 
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S.5.3  TM_WKAFTER  -  Wake  up  after  interval 


INPUT: 

EAX  =  function  code 
4[ESP]  =  length  of  interval  (in  ticks) 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  INTERVAL 

mov  EAX , TM_WKAFTER 

call  r terns 


;  push  ticks  to  wait 
;  EAX  =  function  code 
;  enter  the  executive 


;  should  check  return  code  here 


S.5.4  TM_WKWHEN  -  Wake  up  when  specified 


INPUT: 

EAX  =  function  code 

4[ESP]  =  address  of  timejnfo  data  structure 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Time_str 
mov  EAX , TM_WKWHEN 

call  rtems 


;  push  time  to  wake 
;  EAX  =  function  code 
;  enter  the  executive 


;  should  check  return  code  here 
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S.5.5  TM_EVAFTER  -  Send  event  set  after  interval 

INPUT: 

EAX  =  function  code 

4[ESP]  =  interval  until  event  (in  ticks) 

8[ESP]  =  event  set 

12[ESP]  =  address  of  timer  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Tiiner_id 

;  push  pointer  to  timer  id 

push 

EVENTS 

;  push  events  to  send 

push 

INTERVAL 

;  push  ticks  until  event 

mov 

EAX,TM_BVAFTER 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 
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S.5.6  TM_EVWHEN  -  Send  event  set  when  specified 


INPUT: 

EAX  =  function  code 

4[ESP]  =  address  of  timejnfo  data  structure 

8[ESP]  =  event  set 

12[ESP]  =  address  of  timer  id  storage  location 
OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Timer  id 

push  EVENTS 

push  offset  Time_str 

mov  EAX , TM_EVWHEN 

call  rtems 

;  should  check  return  code  here 


push  pointer  to  timer  id 
push  events  to  send 
push  time  to  send  events 
EAX  ==  function  code 
enter  the  executive 


S-22 


S.5.7  TM_EVEVERY  -  Send  periodic  event  set 


INPUT: 

EAX  =  function  code 

4[ESP]  =  interval  between  events  (in  ticks) 

8[ESP]  =  event  set 

12[ESP]  =  address  of  timer  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Timer  id 

;  push  pointer  to  timer  id 

push 

EVENTS 

;  push  events  to  send 

push 

NUM_TICKS 

;  push  time  between  events 

mov 

EAX, TM_EVE VERY 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 


S.5.8  TM_CANCEL  -  Cancel  timer  event 


INPUT: 

EAX  =  function  code 
4[ESP]  =  timer  event  id 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

push  Timer_id  ; 

mov  EAX,TM_CANCEL  ; 

call  rtems  . 

;  should  check  return  code  here 


S24 


push  timer  id 
EAX  =  function  code 
enter  the  executive 


S.5.9  TM^TICK  -  Announce  a  clock  tick 

INPUT: 

EAX  =  function  code 

OUTPUT: 

EAX  =  SUCCESSFUL 

EXAMPLE: 


mov  EAX,TM_TICK  ;  EAX  = 

call  rtems  ;  enter 


function  code 
the  executive 


no  need  to  check  the  return  code  here 


S.6  SEMAPHORE  MANAGER 

S.6.1  SM_CREATE  -  Create  a  semaphore 

INPUT: 

EAX  =  function  code 

4[ESP]  =  user-defined  four  byte  name 

8[ESP]  =  initial  count 

12[ESP]=  attributes 

16[ESP]=  address  of  semaphore  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 
EXAMPLE: 


push 

offset  sem_id 

push 

SEM_ATTRIBUTES 

push 

lNITIAL_COUNT 

push 

SEMNAME 

mov 

EAX,SM_CREATE 

call 

rtems 

;  should  check  return  code  here 


push  pointer  to  semaphore  id 
push  attributes 
push  initial  count 
push  name 

EAX  =  function  code 
enter  the  executive 
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S.6.2  SMJDENT  -  Get  ID  of  a  semaphore 


INPUT: 

EAX  =  function  code 
4[ESP]  =  user-defined  name  to  search  for 
8[ESP]  =  node  identifier  (defines  search  space) 
12[ESP]=  address  of  semaphore  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Sem_id 

push  NODE 

push  SEM_NAME 

mov  EAX,SM_IDENT 

call  rtems 

;  should  check  return  code  here 


push  pointer  to  semaphore  id 
push  node  identifier 
push  nzune 

EAX  =  function  code 
enter  the  executive 
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S.6.3  SM_DELETE  -  Delete  a  semaphore 


INPUT: 

EAX  =  function  code 
4[ESP]  =  semaphore  id 

OUTPUT: 

EAX  ==  directive  status  code 

EXAMPLE: 

push  Sem_id  ; 

mov  EAX,SM_DELBTE  ; 

call  rtems  ; 

;  should  check  return  code  here 


push  semaphore  id 
EAX  =  function  code 
enter  the  executive 
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S.6.4  SM_P  -  Acquire  a  semaphore 


INPUT; 

EAX  =  function  code 
4[ESP]  =  semaphore  id 
8[ESP]  =  options 

12[ESP]  =  maximum  interval  to  wait  (in  ticks) 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

TIMEOUT 

;  push  maximum  ticks  to  wait 

pi  j*" 

OPTIONS 

;  push  options 

push 

Sein_id 

;  push  semaphore  id 

mov 

EAX,SM_P 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 


S.6.5  SM_V  -  Release  a  semaphore 


INPUT: 

EAX  =  function  code 
4[ESP]  =  semaphore  id 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

push  Sem_id  ; 

mov  EAX,SM_V  • 

call  rtems  • 

;  should  check  return  code  here 
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push  semaphore  id 
EAX  =  function  code 
enter  the  executive 


S.7  MESSAGE  MANAGER 
S.7.1  Q_CREATE  -  Create  a  queue 

INPUT: 

EAX  =  function  code 
4[ESP]  =  user-defined  four  byte  name 
8[ESP]  =  maximum  message  count 
12[ESP]=  attributes 

16[ESP]=  address  of  queue  id  storage  location 


OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Queue_id 
push  Q_ATTRIB 

push  MSG_BUF_COUNT 

push  QUEUE_NAME 

mov  EAX , Q_CREATE 

call  r terns 


push  pointer  to  queue  id 
push  attributes 
push  message  count 
push  name 

EAX  =  function  code 
enter  the  executive 


;  should  check  return  code  here 


S.7.2  Q_IDENT  -  Get  ID  of  a  queue 

INPUT: 

EAX  =  function  code 
4[ESP]  =  user-defined  name  to  search  for 
8[ESP]  =  node  identifier  (defines  search  space) 
12(ESP]=  address  of  queue  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Queue  id 
push  NODE  ~ 

push  QUEUE_NAME 

mov  EAX,Q__ideNT 

call  rtems 

;  should  check  return  code  here 


;  push  pointer  to  queue  id 
;  push  node  identifier 
;  push  name 
;  EAX  =  function  code 
;  enter  the  executive 
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S.7.3  Q_DELETE  -  Delete  a  queue 


INPUT: 

EAX  =  function  code 
4[ESP]  =  queue  id 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

push  Quaue_id 

mov  EAX , Q_DELETE 

call  r terns 


;  push  queue  id 
;  EAX  =  function  code 
;  enter  the  executive 


;  should  check  return  code  here 


S.7.4  Q_SEND  -  Put  message  at  rear  of  a  queue 


INPUT: 

EAX  =  function  code 

4[ESP]  =  queue  id 

8[ESP1  =  address  of  message  buffer 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Message 
push  Queue  id 

mov  EAX,Q_SEND 

call  rtems 

;  should  check  return  code 


;  push  address  of  message 
;  push  queue  id 
;  EAX  =  function  code 
;  enter  the  executive 

here 
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S.7.5  Q  URGENT  -  Put  message  at  front  of  a  queue 


INPUT: 

EAX  =  function  code 

4[ESP]  =  queue  id 

8[ESP]  =  address  of  message  buffer 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Message 

;  push  address  of  message 

push 

Queue_id 

;  push  queue  id 

mov 

EAX,Q_URGENT 

;  EAX  =  function  code 

call 

r  terns 

;  enter  the  executive 

;  should  check  return  code  here 


S.7.6  Q_BROADCAST  -  Broadcast  N  messages  to  a  queue 


INPUT: 

EAX  =  function  code 

4[ESP]  =  queue  id 

8[ESP]  =  address  of  message  buffer 

12[ESP]=  address  of  "number  of  tasks  made  ready"  storage  location 
OUTPUT: 

EAX  =  directive  status  code 
EXAMPLE: 


push  offset  Nuin_tasks 

push  offset  Message 

push  Queue_id 

mov  EAX , Q_BROADCAST 

call  rtems 


push  pointer  to  number 
of  tasks  readied 
push  address  of  message 
push  queue  id 
EAX  =  function  code 
enter  the  executive 


;  should  check  return  code  here 
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S.7.7  Q  RECEIVE  -  Receive  message  from  a  queue 


INPUT: 

EAX  =  function  code 

4[ESP]  =  queue  id 

8[ESP]  =  address  of  message  buffer 

12[ESP]=  options 

1 6[ESP]  =  maximum  interval  to  wait  (in  ticks) 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

TIMEOUT 

;  push  maximum  ticks  to  wait 

push 

OPTIONS 

;  push  receive  options 

push 

offset  Message 

;  push  pointer  to  message 

push 

Queue_id 

;  push  queue  id 

mov 

EAX,Q_RECEIVE 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 


S.7.8  Q_FLUSH  -  Flush  all  messages  on  a  queue 


INPUT: 

EAX  =  function  code 
4[ESP]  =  queue  id 

8[ESP]  =  address  of  "number  of  messages  flushed"  storage  location 

OUTPUT: 

EAX  =  directive  status  code 
EXAMPLE: 


push 

offset  Nuin_flushed 

t 

push  pointer  to  number 

of  messages  flushed 

push 

Queue_id 

# 

i 

push  queue  id 

mov 

EAX,Q_FLUSH 

• 

EAX  =  function  code 

call 

rtems 

e 

0 

enter  the  executive 

;  should  check  return  code  here 
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S.8  EVENT  MANAGER 

S.8.1  EV_SEND  -  Send  event  set  to  a  task 

INPUT: 

EAX  =  function  code 
4[ESP]  =  task  id  to  send  events  to 
8[ESP]  =  event  set  to  send 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

EVENTS 

;  push  events  to 

send 

push 

Task_id 

;  push  task  id 

mov 

EAX,EV_SEND 

;  EAX  =  function 

code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 


S.8.2  r  -  RECEIVE  -  Receive  event  condition 

INPUT: 

EAX  =  function  code 
4[ESP]  =  input  event  condition 
8[ESP]  =  options 

12[ESP]=  maximum  interval  to  wait  (in  ticks) 

16[eSP]=  address  of  events  received  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Events_recvd 
push  TIMEOUT 

push  OPTIONS 

push  EVENTS 

mov  EAX , EV_RECE I VE 

call  rtems 

;  should  check  return  code  here 


push  pointer  to  events  received 
push  maximum  ticks  to  wait 
push  receive  options 
push  event  condition 
EAX  ==  function  code 
enter  the  executive 
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S.9  SIGNAL  MANAGER 

S.9.1  AS_CATCH  -  Establish  an  ASR 

INPUT: 

EAX  =  function  code 
4[ESP]  =  address  of  ASR 
8[ESP]  =  mode  of  ASR 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

ASR_MODE 

;  push  ASR  mode 

push 

offset  Aar 

;  push  ASR  address 

mov 

EAX,AS_CATCH 

;  EAX  =  function  code 

call 

rtema 

;  enter  the  executive 

;  should  check  return  code  here 


S.9.2  AS^SEND  -  Send  signal  set  to  a  task 


INPUT: 

EAX  =  function  code 
4[ESP]  =  task  id 
8[ESP]  =  signal  set 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  SIGNALS 

push  Task_id 

mov  EAX,AS_SEND 

call  rtems 

;  should  check  return  code 


;  push  signals  to  send 
;  push  task  id 
;  EAX  =  function  code 
;  enter  the  executive 

here 
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S.9.3  AS  ENTER  -  Enter  an  ASR 


INPUT: 

EAX  =  function  code 

OUTPUT: 

NONE 

EXAMPLE: 

push  EAX  ;  save  task's  EAX 

mov  EAX,AS_ENTER  ;  EAX  =  function  code 

call  rtems  ;  enter  the  executive 

;  no  need  to  check  the  return  code  here 


NOTES: 

This  directive  uses  the  ElAX  register  only.  This  register  must  be  saved  by  the 
application  before  invoking  AS_ENTER  The  ElAX  register  is  restored 
automatically  by  the  AS.RETURN  directive. 


S-43 


S.9.4  AS^RETURN  -  Return  from  an  ASR 

INPUT: 

EAX  =  function  code 

OUTPUT: 

DO  =  directive  status  code 

EXAMPLE: 


mov  EAX,AS_RETURN  ;  EAX  =  function  code 

call  rtems  ;  enter  the  executive 

;  does  not  return  if  SUCCESSFUL 


NOTES: 

This  directive  uses  the  BlAX  only.  It  restores  ElAX  to  its  contents  prior  to 
invoking  I_ENTER 

If  successful,  this  directive  does  not  return  to  the  caller. 
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S.10 


PARTITION  MANAGER 
PT_CREATE  -  Create  a  partition 


S.10.1 

INPUT: 

EAX  =  function  code 
4[ESP]  =  user-defined  four  byte  name 
8[ESP]  =  physical  start  address  of  partition 
12[ESP]=  length  (in  bytes) 

16[ESP]=  size  of  buffers  (in  bytes) 

20[ESP]  =  attributes 

24[ESP]  -  address  of  partition  id  storage  location 


OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

push  offset  Part_id 

push  PART_ATTRIBUTES 

push  BUF_SIZE 

push  PART_LENGTH 

push  PART_ADDR 

push  PART_NAME 

mov  EAX , PT_CREATE 

call  rtems 

;  should  check  return  code 


;  push  pointer  to  partition  id 
;  push  attributes 
;  push  buffer  size 
;  push  length 
;  push  start  address 
;  push  name 
;  EAX  =  function  code 
;  enter  the  executive 

here 
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S.10.2  PT_IDENT  -  Get  ID  of  a  partition 


INPUT: 

EAX  =  function  code 
4[ESP]  =  user-defined  name  to  search  for 
8[ESP]  =  node  identifier  (defines  search  space) 
12[ESP]=  address  of  partition  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 
EXAMPLE: 


push 

offset  Part_id 

;  push  pointer  to  partition 

push 

NODE 

;  push  node  identifier 

push 

PART_NAME 

;  push  name 

mov 

EAX,PT_IDENT 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 
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S.1 0.3  PT_DELETE  -  Delete  a  partition 


INPUT: 

EAX  =  function  code 
4[ESP]  =  partition  id 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

push  Part_id  ; 

mov  EAX,PT_DELETE  ; 

call  rtema  ; 

;  should  check  return  code  here 


push  partition  id 
EAX  =  function  code 
enter  the  executive 


S.1 0.4  PT_GETBUF  -  Get  buffer  from  a  partition 

INPUT: 

EAX  =  function  code 
4[ESP]  =  partition  id 

8[ESP1  =  address  of  "buffer  address"  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Buff  addr 

;  push 

pointer  to  buffer  address 

push 

Part_id 

;  push  partition  id 

mov 

EAX,PT__GETBUF 

;  EAX  = 

function  code 

call 

rtems 

;  enter 

the  executive 

;  should  check  return  code  here 
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S.1 0.5  PT_RETBUF  -  Return  buffer  to  a  partition 

INPUT; 

EAX  =  function  code 
4[ESP]  =  partition  id 
8[ESP]  =  buffer  start  address 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

Buff_addr 

;  push  buffer  address 

push 

Part_id 

;  push  partition  id 

mov 

EAX, PT_RETBUF 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 


S.11  REGION  MANAGER 

S.1 1 .1  RN_CREATE  -  Create  a  region 


INPUT: 


EAX  =  function  code 


4[ESP]  =  user-defined  four  byte  name 
8[ESP]  =  physical  start  address  of  region 
12[ESP]=  length  (in  bytes) 

16[ESP]=  page  size  (in  bytes) 

20[ESP]=  attributes 

24[ESP]  =  address  of  region  id  storage  location 


OUTPUT: 

EAX  =  directive  status  code 


EXAMPLE: 


s 


push  offset  Regn__id  ; 
push  REGN_ATTRIB  • 
push  REGN_PAGE  ; 
push  REGN_LENGTH  ; 
push  REGN_ADDRESS  ; 
push  REGN_NAME  ; 
mov  EAX,RN_CREATE  ; 
call  rtems  ; 

;  should  check  return  code  here 


push  pointer  to  region  id 
push  attributes 
push  page  size 
push  length 

push  physical  starting  address 
push  name 

EAX  =  function  code 
enter  the  executive 
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S.1 1 .2  RNJDENT  -  Get  ID  of  a  region 


INPUT: 

EAX  =  function  code 

4[ESP]  =  user-defined  name  to  search  for 

8[ESP]  =  address  of  region  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Regn  id 

;  push  pointer  to  region  id 

push 

REGN_NAME 

;  push  name 

mov 

EAX,RN_IDENT 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 


S.1 1 .3  RN_DELETE  -  Delete  a  region 


INPUT: 

EAX  =  function  code 
4[ESP]  =  region  id 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 

push  Regn_id  ; 

mov  EAX,RN_DELETE  ; 

call  rtems  . 

;  should  check  return  code  here 
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push  region  id 
EAX  =  function  code 
enter  the  executive 


S.1 1 .4  RN_GETSEG  -  Get  segment  from  a  region 

INPUT: 

EAX  =  function  code 
4[ESP]  =  region  id 

8[ESP]  =  segment  size  desired  (in  bytes) 

12[ESP]=  options 

1 6[ESP]  =  maximum  interval  to  wait  (in  ticks) 

20[ESP]  =  address  of  "segment  address"  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Seg_addr 

;  push  pointer  to  segment  address 

push 

TIMEOUT 

;  push  maximum  ticks  to  wait 

push 

OPTIONS 

;  push  getseg  options 

push 

SEG_SIZE 

;  push  desired  segment  size 

push 

Regn_id 

;  push  region  id 

mov 

EAX,RN_GETSEG 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 


S-53 


S.11 .5  RN_RETSEG  -  Return  segment  to  a  region 

INPUT: 

EAX  =  function  code 
4[ESP]  =  region  id 
8[ESP]  =  segment  address 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

Seg_addr 

;  push  segment  address 

push 

Regn  id 

;  push  region  id 

mov 

EAX,RN_RETSEG 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

?  should  check  return  code  here 


S.1 2  DUAL-PORTED  MEMORY  MANAGER 
S.1 2.1  DP_CREATE  -  Create  a  port 

INPUT: 

EAX  =  function  code 
4[ESP]  =  user-defined  four  byte  name 
8[ESP]  =  starting  internal  address 
12[ESP]=  starting  external  address 
1 6[ESP]  =  length  (in  bytes) 

20[ESP]  =  address  of  port  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Port_id 
push  PORT_LENGTH 

push  External_addr 

push  Internal_addr 

push  PORT_NAME 

mov  EAX , DP_CREATE 

call  r terns 


push  pointer  to  port  id 
push  length  of  DPMA 
push  external  address 
push  internal  address 
push  name 

EAX  =  function  code 
enter  the  executive 


;  should  check  return  code  here 


S.12.2  DPJDENT  -  Get  ID  Of  a  port 


INPUT: 

EAX  =  function  code 

4[ESP]  =  user-defined  name  to  search  for 

8[ESP]  =  address  of  port  id  storage  location 

OUTPUT: 

EAX  =  directive  status  code 
EXAMPLE: 


push 

offset  Port_id 

;  push  pointer  to  port  id 

push 

PORT_NAME 

;  push  name 

mov 

EAX, DP_I DENT 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  return  code  here 
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S.1 2.3  DP_DELETE  -  Delete  a  port 


INPUT: 

EAX  =  function  code 
4[ESP]  =  port  id 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  Port_id 

mov  EAX,  DP_DELETE 

call  r terns 


;  push  port  id 
;  EAX  =  function  code 
;  enter  the  executive 


;  should  check  return  code  here 


S.12.4  DP_2INTERNAL  -  Convert  external  to  internal  address 

INPUT: 

EAX  =  function  code 
4[ESP]  =  port  id 
8[ESP]  =  external  address 

12[ESP]  =  address  of  "internal  address"  storage  location 
OUTPUT: 

EAX  =  directive  status  code 
EXAMPLE: 


push 

offset  lnternal_addr 

push  pointer  to  internal  address 

push 

External_addr 

push  external  address 

push 

Port_id 

push  port  id 

mov 

EAX , DP_2 INTERNAL 

EAX  =  function  code 

call 

rtems 

enter  the  executive 

;  should  check  return  code  here 
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S.1 2.5  DP_2EXTERNAL  -  Convert  internal  to  external  address 

INPUT: 

EAX  =  function  code 
4[ESP]  =  port  id 
8[ESP]  =  internal  address 

12[ESP]=  address  of  "external  address"  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  External_addr 

push  Internal_addr 

push  Port_id 

mov  EAX,DP_2EXTERNAI. 

call  r terns 


push  pointer  to  external  address 

push  internal  address 

push  port  id 

EAX  =  function  code 

enter  the  executive 


;  should  check  return  code  here 
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S.13 


INPUT/OUTPUT  MANAGER 
DE  INIT  -  Initialize  a  device  driver 


S.13.1 

INPUT: 

EAX  =  function  code 

4[ESP]  =  device  number 

8[ESP]  =  address  of  parameter  block 

12[ESP]=  address  of  "return  code  from  device  driver"  storage  location 
OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Driver_rval 

t 

push  pointer  to  driver's 

t 

return  code 

push 

offset  Param_blk 

« 

0 

push  pointer  to  parameter  block 

push 

DEV_NUM 

0 

push  device  number 

mov 

EAX,DE_1NIT 

0 

EAX  =  function  code 

call 

rtems 

• 

0 

enter  the  executive 

;  should  check  directive's  return  code  here 
;  should  check  device  driver's  return  code  here 
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S.1 3.2  DE  OPEN  -  Open  a  device 

INPUT: 

EAX  =  function  code 

4[ESP]  =  device  number 

8[ESP]  =  address  of  parameter  block 

12[ESP]=  address  of  "return  code  from  device  driver"  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Driver  rval 

;  push  pointer  to  driver's 

;  return  code 

push 

offset  Param  blk 

;  push  pointer  to  parameter  block 

push 

DEV_NUM 

;  push  device  number 

mov 

EAX,DE_OPEN 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  directive's  return  code  here 
;  should  check  device  driver's  return  code  here 
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S.13.3  DE  CLOSE  -  Close  a  device 


INPUT: 

EAX  =  function  code 

4[ESP]  =  device  number 

8[ESP]  =  address  of  parameter  block 

12[ESP]=  address  of  "return  code  from  device  driver"  storage  location 
OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Driver_rval 

push  offset  Parain_blk 

push  DEV_NUM 

mov  EAX,DE_CLOSE 

call  r terns 

;  should  check  directive's  return  code  here 
;  should  check  device  driver's  return  code  here 


push  pointer  to  driver's 
return  code 

push  pointer  to  parameter  block 
push  device  number 
EAX  =  function  code 
enter  the  executive 
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S.1 3.4  DE  READ  -  Read  from  a  device 


INPUT: 

EAX  =  function  code 

4[ESP]  =  device  number 

8[ESP]  =  address  of  parameter  block 

1 2[ESP]  =  address  of  "return  code  from  device  driver"  storage  location 
OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Driver_rval 

push  offset  Param_blk 

push  DEV_NUM 

mov  EAX,DE_READ 

call  rtems 

;  should  check  directive's  return  code  here 
;  should  check  device  driver's  return  code  here 


push  pointer  to  driver's 
return  code 

push  pointer  to  pareuneter  block 
push  device  number 
EAX  =  function  code 
enter  the  executive 
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S.1 3.5  DE  WRITE  -  Write  to  a  device 


INPUT: 

EAX  =  function  code 

4[ESP]  =  device  number 

8[ESP]  =  address  of  parameter  block 

12[ESP]  =  address  of  "return  code  from  device  driver"  storage  location 
OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push  offset  Driver_rvaL 

push  offset  parain_blk 

push  DEV_NUM 

mov  EAX , DE_WRI TE 

call  rtems 

;  should  check  directive's  return  code  here 
;  should  check  device  driver's  return  code  here 


push  pointer  to  driver ' s 
return  code 

push  pointer  to  parameter  block 
push  device  number 
EAX  =  function  code 
enter  the  executive 
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S.1 3.6  DE_CNTRL  •  Special  device  services 


INPUT: 

EAX  =  function  code 

4[ESP]  =  device  number 

8[ESP]  =  address  of  parameter  block 

1 2[ESP]  =  address  of  "return  code  from  device  driver"  storage  location 

OUTPUT: 

EAX  =  directive  status  code 

EXAMPLE: 


push 

offset  Driver  rval 

;  push  pointer  to  driver's 

;  return  code 

push 

offset  Param  blk 

;  push  pointer  to  parameter  block 

push 

DEV_NUM 

;  push  device  number 

mov 

EAX,DE_CNTRL 

;  EAX  =  function  code 

call 

rtems 

;  enter  the  executive 

;  should  check  directive's  return  code  here 
;  should  check  device  driver's  return  code  here 
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S.14  FATAL  MANAGER 

S.1 4.1  K__FATAL  -  Invoke  the  fatal  error  handler 


INPUT: 

EAX  =  function  code 
4[ESP1  =  error  code 

OUTPUT: 

NONE 

EXAMPLE: 


push  Fatal_error 
mov  EAX , K_F AT AL 
call  rtems 

;  will  never  return 


;  push  error  code 
;  EAX  =  function  code 
;  enter  the  executive 


NOTES: 

This  directive  does  not  return  to  the  caller. 
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S.1 5  MULTIPROCESSING  MANAGER 

S.1 5.1  MP_ANNOUNCE  -  Announce  the  arrival  of  a  packet 

INPUT: 

EAX  =  function  code 

OUTPUT: 

NONE 

EXAMPLE: 


mov  EAX,MP_ANNOUNCE  ;  EAX  =  function  code 

call  rtems  ;  enter  the  executive 


;  no  need  to  check  the  return  code  here 


S.16  directives.eq 


directives . eq 


The  following  definitions  are  the  directive  numbers  used 
in  the  assembly  interface. 


INIT_EXEC 

I_ENTER 

I_RETURN 

K_FATAL 

TM_SET 

TM_GET 

TM_WKAFTER 

TM_MKWHEN 

TM_EVAFTER 

TM_EVWHEN 

TM_EVEVERY 

TM_CANCEL 

TM_TICK 

T_CREATE 

T_IDENT 

T_START 

T_RESTART 

T_DELETE 

T_SUSPEND 

T_RESUME 

t_setpri 

T_MODE 

T_GETNOTE 

T_SETNOTE 

EV_SEND 

EV_RECEIVE 

AS_CATCH 

AS_SEND 

AS_ENTER 

AS_RETURN 

Q_CREATE 

Q_IDENT 

Q_DELETE 

Q_SEND 

Q_URGENT 

Q_BROADCAST 

Q  RECEIVE 


EQU 

0 

EQU 

1 

EQU 

2 

EQU 

3 

EQU 

4 

EQU 

5 

EQU 

6 

EQU 

7 

EQU 

8 

EQU 

9 

EQU 

10 

EQU 

11 

EQU 

12 

EQU 

13 

EQU 

14 

EQU 

15 

EQU 

16 

EQU 

17 

EQU 

18 

EQU 

19 

EQU 

20 

EQU 

21 

EQU 

22 

EQU 

23 

EQU 

24 

EQU 

25 

EQU 

26 

EQU 

27 

EQU 

28 

EQU 

29 

EQU 

30 

EQU 

31 

EQU 

32 

EQU 

33 

EQU 

34 

EQU 

35 

EQU 

36 
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Q_FLUSH 

SM_CREATE 

SM_IDENT 

SM_DELETE 

SM_P 

SM_V 

RN_CREATE 

RN_IDENT 

RN_DELETE 

RN_GETSEG 

RN_RETSEG 

PT_CREATE 

PT_IDENT 

PT_DELETE 

PT_GETBUF 

PT_RETBUF 

DP_CREATE 

DP_IDENT 

DP_DELETE 

DP_2 INTERNAL 

DP_2EXTERNAL 

MP_ANNOUNCE 

DE_INIT 

de_open 

DE_CLOSE 
DE_READ 
DE_WRITE 
DE  CNTRL 


EQU 

37 

EQU 

38 

EQU 

39 

EQU 

40 

EQU 

41 

EQU 

42 

EQU 

43 

EQU 

44 

EQU 

45 

EQU 

46 

EQU 

47 

EQU 

48 

EQU 

49 

EQU 

50 

EQU 

51 

EQU 

52 

EQU 

53 

EQU 

54 

EQU 

55 

EQU 

56 

EQU 

57 

EQU 

58 

EQU 

59 

EQU 

60 

EQU 

61 

EQU 

62 

EQU 

63 

EQU 

64 

BEGIN_CODE_DCL 

EXTRN  rtemstnear  ;  single  RTEMS  entry  point 

END_CODE_DCL 

;  end  of  directives .eg 

i 

.  * ************************************************** *********** 


S-69 


S.17  dirstatus.eq 


********************************************************* 

dirstatus .eg 

This  include  file  contains  the  status  codes  returned 
from  the  executive's  directives. 


SUCCESSFUL  EQU  0 
E_EXITTED  EQU  1 
E_NOMP  EQU  2 
ENAME  EQU  3 
E_ID  EQU  4 
E_TOOMANY  EQU  5 
E_TIMEOUT  EQU  6 
E_DELETE  EQU  7 
E_SIZE  EQU  8 
E_ADDRESS  EQU  9 
E_NUMBER  EQU  10 
E_NOTDEFINED  EQU  11 
E_INUSE  EQU  12 
E_UNSATISFIED  EQU  13 
E_STATE  EQU  14 
E_ALREADy  EQU  15 
E_SELF  EQU  16 
E_REMOTE  EQU  17 
E_CALLED  EQU  18 
E_PRIORITY  EQU  19 
E_CLOCK  EQU  20 
E_NODE  EQU  2 1 
E_NOTCONFIGURED  EQU  22 
E  NOTIMPLEMENTED  EQU  23 


successful  completion 
returned  from  a  task 
mp  not  configured 
invalid  object  name 
invalid  object  id 
too  many 

timed  out  waiting 
object  deleted  while  waiting 
specified  size  was  invalid 
address  specified  is  invalid 
number  was  invalid 
item  has  been  initialized 
resources  still  outstanding 
request  not  satisfied 
task  is  in  wrong  state 
task  already  in  state 
illegal  on  calling  task 
illegal  on  remote  object 
called  from  wrong  environment 
invalid  task  priority 
invalid  date/time 
invalid  node  id 
directive  not  configured 
directive  not  implemented 


end  of  dirstatus.eq 
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